.TH "OSM2PGSQL" "1" "2.0.1" "" ""
.SH NAME
.PP
osm2pgsql-gen - Generalize OpenStreetMap data - EXPERIMENTAL!
.SH SYNOPSIS
.PP
\f[B]osm2pgsql-gen\f[R] [\f[I]OPTIONS\f[R]]\&...
.SH DESCRIPTION
.PP
THIS PROGRAM IS EXPERIMENTAL AND MIGHT CHANGE WITHOUT NOTICE!
.PP
\f[B]osm2pgsql-gen\f[R] reads data imported by \f[B]osm2pgsql\f[R] from
the database, performs various generalization steps specified by a Lua
config file and writes the data back to the database.
It is used in conjunction with and after \f[B]osm2pgsql\f[R] and reads
the same config file.
.PP
This man page can only cover some of the basics and describe the command
line options.
See the Generalization chapter in the osm2pgsql
Manual (https://osm2pgsql.org/doc/manual.html#generalization) for more
information.
.SH OPTIONS
.PP
This program follows the usual GNU command line syntax, with long
options starting with two dashes (\f[V]--\f[R]).
Mandatory arguments to long options are mandatory for short options too.
.SH MAIN OPTIONS
.TP
-a, --append
Run in append mode.
The default is to run in create mode.
.TP
-S, --style=FILE
The Lua config file.
Same as for \f[B]osm2pgsql\f[R].
Usually not required because it is read from the
\f[V]osm2pgsql_properties\f[R] table.
.TP
-j, -jobs=NUM
Specifies the number of parallel threads used for certain operations.
Setting this to the number of available CPU cores is a reasonable
starting point.
Minimum value and default is 1, maximum value is 256.
.SH HELP/VERSION OPTIONS
.TP
-h, --help
Print help.
.TP
-V, --version
Print osm2pgsql version.
.SH LOGGING OPTIONS
.TP
--log-level=LEVEL
Set log level (`debug', `info' (default), `warn', or `error').
.TP
--log-sql
Enable logging of SQL commands for debugging.
.SH DATABASE OPTIONS
.TP
-d, --database=NAME
The name of the PostgreSQL database to connect to.
If this parameter contains an \f[V]=\f[R] sign or starts with a valid
URI prefix (\f[V]postgresql://\f[R] or \f[V]postgres://\f[R]), it is
treated as a conninfo string.
See the PostgreSQL manual for details.
.TP
-U, --username=NAME
Postgresql user name.
.TP
-W, --password
Force password prompt.
.TP
-H, --host=HOSTNAME
Database server hostname or unix domain socket location.
.TP
-P, --port=PORT
Database server port.
.TP
--schema=SCHEMA
Default for various schema settings throughout osm2pgsql-gen (default:
\f[V]public\f[R]).
The schema must exist in the database and be writable by the database
user.
It must be the same as used with \f[V]osm2pgsql\f[R].
.TP
--middle-schema=SCHEMA
Database schema where the \f[V]osm2pgsql_properties\f[R] table is to be
found.
Default set with \f[V]--schema\f[R].
Set to the same value as on the \f[V]osm2pgsql\f[R] command line.
.SH SEE ALSO
.IP \[bu] 2
osm2pgsql website (https://osm2pgsql.org)
.IP \[bu] 2
osm2pgsql manual (https://osm2pgsql.org/doc/manual.html)
.IP \[bu] 2
\f[B]postgres\f[R](1)
.IP \[bu] 2
\f[B]osm2pgsql\f[R](1)
